home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 1 / Amiga Tools.iso / wb-tools / blanker / aswarmii / aswarm.dok < prev    next >
Text File  |  1994-06-06  |  31KB  |  747 lines
  1.                         ASwarm II V1.3 - Anleitung
  2.  
  3.  
  4. NAME
  5.     SYS:WBStartup/ASwarm
  6.  
  7. SYNOPSIS
  8.     ASwarm
  9.      CX_PRIORITY/N/K     : <System Priorität>
  10.      CX_POPKEY/K         : <Tastenbefehl Beschreibung>
  11.      CX_POPUP/S          : <Yes | No>
  12.      BLANKKEY/K          : <Tastenbefehl Beschreibung>
  13.      SECONDS=TIMEOUT/N/K : <1 - 3600>
  14.      CLIENTTIMEOUT/N/K   : <1 - 60>
  15.      DISPLAY/K           : <Bildschirmauflösungs Beschreibung>
  16.      CYCLE/S             : <Yes | No>
  17.      AIM/S               : <Yes | No>
  18.      WASPS/N/K           : <1 - 10>
  19.      BEES/N/K            : <1 - 500>
  20.      SPEED/N/K           : <1 - 4>
  21.      TIGHTNESS/N/K       : <1 - 10>
  22.      MOUSEBLANKMETHOD/K  : <Hardware | FreeSprite>
  23.  
  24. BESCHREIBUNG
  25.  
  26.    Bildschirmschoner mit hoher Sicherheit, brennt nicht seine
  27.    Grafik auf den Schirm wenn die CPU belastet ist.
  28.    Lustig anzusehen. Läuft nur unter Workbench Release 2.04 oder neuer.
  29.  
  30. QUELLSOURCE
  31.  
  32.    Die Quellsource ist beigefügt, kann mit SAS/C 5.10a oder mit einer
  33.    registrierten Version von DICE V2.06.40 oder höher kompiliert werden.
  34.    Die Sourcen sind beigefügt, um einen Einblick in das Client/Server
  35.    Modell von ASwarm II zu geben, sowie in das Commodity Interface.
  36.    Bitte verbreiten Sie keine verbesserten Versionen von ASwarm II unter
  37.    dem Namen von ASwarm. Dies führt zu Verwirrungen in der Öffentlichkeit,
  38.    und ist auch unfair.
  39.  
  40. COPYRIGHT
  41.    ASwarm II V1.3 ist frei kopierbar (freely distributable).
  42.    ASwarm II V1.3 darf frei auf Public-Domain und Shareware Disketten,
  43.    speziell auf der von Fred Fish vertriebenen AmigaLibDisk Serie, vertrieben
  44.    werden, solange diese nicht einen angemessenen Preis der niedriger als $6
  45.    oder DM 8.- pro Diskette überschreitet.
  46.    Zur Benutzung in kommerziellen Produkten ist eine Erlaubnis bei den
  47.    Autoren einzuholen.
  48.    ASwarm II V1.3 darf kopiert und vertrieben werden über elektronische
  49.    Netzwerke wie z.B. das Internet, auch darf es auf anonymen FTP-Servern,
  50.    Mail-Boxen oder Boards abgelegt werden.
  51.    Das Copyright liegt immer noch bei den Autoren.
  52.    Die Sourcen dürfen verändert oder verbessert werden. Bitte verbreiten
  53.    Sie KEINE eigene Version von ASwarm II unter dem Namen von ASwarm, dies
  54.    führt nur zu Verwirrungen in der Öffentlichkeit. So geschehen bei
  55.    ASwarm III, welches nicht unser Produkt ist.
  56.    Schicken Sie uns einfach eine Notiz, was Sie geändert haben, sollte Sie
  57.    es wirklich für notwendig empfinden, eine eigene Version zu verbreiten,
  58.    benutzen Sie bitte einen anderen Namen.
  59.  
  60.  
  61. AUTOR & SUPPORT
  62.    Markus Illenseer           # Grafik Routinen
  63.    Kurt-Schumacherstr. 16      # Dokumentation
  64.    D-4800 Bielefeld 1           # Dice Support
  65.    Germany
  66.    INTERNET: markus@techfak.uni-bielefeld.de
  67.    ZERBERUS: markus%techfak.uni-bielefeld.de@uucp.zer
  68.    IRC: ill
  69.  
  70.    Matthias Scheler            # Server-Client Model
  71.    Schützenstraße 18            # User Interface
  72.    D-4799 Borchen/Nordborchen    # SAS/C Support
  73.    Germany
  74.    INTERNET: tron@uni-paderborn.de
  75.    FIDO:     Matthias Scheler@2:242/55.36
  76.    ZERBERUS: tron%uni-paderborn.de@uucp.zer
  77.    IRC: Tron
  78.  
  79.    SUPPORT FTP ADDRESSE:
  80.    ftp.uni-paderborn.de [131.334.2.32] Anonymous Zugriff.
  81.    amiga.physik.unizh.ch [130.60.80.80] Anonymous Zugriff.
  82.  
  83.    Bitte lesen sie erst die Sparte 'BEKANNTE PROBLEME' durch, bevor Sie uns
  84.    wegen eines Bug-Reports ansprechen, jeder Kommentar ist willkommen.
  85.  
  86. ÄNDERUNGEN
  87.  
  88.    Für diejenigen, die ASwarm II V1.0 oder V1.1 bereits kennen, bitte sehen
  89.    Sie sich die Kapitel "Synopsis" und "Start" an. Version 1.2 von ASwarm II
  90.    hat starke Veränderungen erfahren. V1.3 flickt ein paar Bugs und ist
  91.    für die neuen Grafikmodi erweitert worden.
  92.  
  93.    Wenn Sie ASwarm im "SYS:WBStartup"-Ordner starten (oder von der
  94.    Workbench im Allgemeinen), schauen Sie sich die neue "Save-Config" Routine
  95.    an, die es Ihnen Ermöglicht, die Tool Types von ASwarm's Icon bequem zu
  96.    ändern.
  97.  
  98.    Ab Version ASwarm II V1.3 haben wir die Grafikroutinen so geändert,
  99.    das sie auch mit den neuen interleaved bitmaps der Workbench 3.0 und
  100.    den verschiedenen VGA Grafikkarten die jetzt erhältlich sind, laufen.
  101.  
  102.    Der Inputhandler wurde komplet umgeschrieben.
  103.  
  104.    Des weiteren haben wir endlich den Fehler gefunden, der verursachte, das
  105.    die Bienen bei aktiviertem Aim-Modus im unteren Bereich des Schirms
  106.    umhertänzelten, wenn sie keine Wespe fanden.
  107.  
  108. VERWENDUNG & THEORIE
  109.    ASwarm ist ein Bildschirmschoner. Die Grafik während der Schonphase baut
  110.    locker auf Jeff Butterworth's 'xswarm' unter X11-Windows auf.
  111.  
  112.    Eines Bildschirmschoners Ziel sollte es sein, den Bildschirm
  113.    abzuschalten, bzw. jedwelche Ausgabe auf den Schirm zu vermeiden, und
  114.    somit zu verhindern, das sich Pixel einbrennen, oder Geisterbilder
  115.    entstehen.
  116.  
  117.    Da es langweilig ist, nur einfach den Schirm abzuschalten, und der Amiga
  118.    nun einmal Multitasking fähig ist, könnten wir doch auch ein paar lustige
  119.    Sachen auf den Bildschirm zaubern, solage der Schirm abgeschaltet ist.
  120.  
  121.    Nur müssen wir aufpassen, das unsere eigene Grafik sich nicht in den
  122.    Bildschirm einbrennt.
  123.  
  124.    Das passiert, wenn der Schoner nicht genug Zeit hat zu malen, so das die
  125.    Grafik sich nicht bewegen kann. Der Schoner hat nicht genug Zeit, wenn
  126.    bereits ein anderes Programm viel Zeit des Prozessors benutzt, so etwa ein
  127.    C-Compiler oder ein Raytracer.
  128.  
  129.    Da ein Schoner nun mal nicht wichtig ist für den User, haben wir zwei
  130.    Wege gefunden: Der Schoner hat CPU-Zeit oder nicht. Wenn er CPU-Zeit
  131.    hat, dann soll er auch lustig malen dürfen. Hat er sie nicht, muss die
  132.    Mal-Routine abgeschaltet werden, und der Schirm ist wirklich schwarz zu
  133.    schalten, bis er wieder CPU-Zeit findet.
  134.  
  135.    Dies machen wir mit einem einfachen Server-Client Model (Steuerprogramm
  136.    und Ge-Steuertes Programm). Der Server läuft mit einer normalen
  137.    Priorität, und hat nur eine einfache WaitPort()-Schleife (also keine echte
  138.    CPU-Zeit Nutzung!) um den Aufwand der CPU zu erkennen. Der Client wird vom
  139.    Server gestartet, wenn das TIMEOUT (Zeit in der keine Eingabe erfolgte)
  140.    erreicht wurde. Der Client läuft mit einer niedrigen Priorität. Hat der
  141.    Server das CLIENTTIMEOUT (Zeit die der Client hat, um zu malen) erreicht,
  142.    und bemerkt, das der Client nicht malen konnte, dann wird der Schirm
  143.    wirklich abgeschaltet.
  144.  
  145.    Es gab eine Diskussion auf comp.sys.amiga.misc (Usenet) in der es um
  146.    Screenblanker ging. Ich finde, alle dort angesprochenen Features und
  147.    Voraussetzungen werden von ASwarm erfüllt.
  148.  
  149. VERSION
  150.    Um einem Versions-Krieg vorzubeugen, haben wir ASwarm nach ASwarm II
  151.    umbenannt. Es gibt bereits andere ASwarm oder Swarm, so etwa ein ASwarm als
  152.    IPC-Port-Blanker für DMouse, geschrieben von Markus Illenseer (in
  153.    KickPascal, mit Source erhältlich auf Anfrage), oder Swarm von Cristian von
  154.    Roques mit Assembler-unterroutinen für die Grafik, leider nicht mit
  155.    der Mehrschwarm-Option, ebenfalls für DMouse.
  156.  
  157.    Da ASwarm sowohl mit dem DICE als (oder) auch mit dem SAS/C übersetz werden
  158.    kann, können Sie die aktuelle Version mit dem (CLI-)Kommando:
  159.    "Version ASwarm FULL" herausfinden. Es wird den benutzen Compiler angeben.
  160.    Default sollte SAS/C sein. Auch die Grösse sollte sich unterscheiden.
  161.       19284  Bytes für die DICE Version.
  162.       16996  Bytes für die SAS/C Version.
  163.  
  164.    Unglücklicherweise hat Jake Rose unser ASwarm II V1.0 'verbessert', und
  165.    es unter dem Namen ASwarm III verbreitet (Der Name ist korrekt, es ist
  166.    ja eine neue Version).
  167.  
  168.    Bitte benutzen Sie diese Version von ASwarm NICHT, sie hat zuviele
  169.    Bugs (sorry Jake, nicht Dein Fehler). Diese Fehler wurden bereits in der
  170.    Version 1.1 oder 1.2 beseitigt. Es ist möglich, das ASwarm III und
  171.    natürlich unsere alte Version ASwarm II 1.0 Ihre Machine zum Absturz
  172.    bringt.
  173.  
  174. START
  175.    ASwarm ist ein Commodity, deshalb läuft es _nur_ unter der Workbench
  176.    Release 2.0 (V37.175) und neuer. Ein Commodity wird normalerweise im
  177.    "SYS:WBStartup"-Ordner gestartet. So wird es automatisch gestartet, wenn
  178.    die Workbench gestartet wird (LoadWB, üblichweise in "S:Startup-Sequence").
  179.    Also kopieren Sie einfach "ASwarm" und "ASwarm.info" nach "SYS:WBStartup",
  180.    oder klicken und schieben sie das Icon dorthin.
  181.  
  182.    Um ASwarm jetzt zu starten, ohne neu booten zu müssen, klicken Sie in
  183.    gewohnter Weise auf das Icon. Wenn die Tool Types noch nicht geändert
  184.    wurden, wird ein Fenster geöffnet. Sollte dies nicht der Fall sein, klicken
  185.    Sie das Icon nocheinmal an.
  186.    Das ist das Konfigurationsfenster von ASwarm.
  187.  
  188.    Klicken Sie nun auf das Gadget 'Hide' oder auf das 'Close-gadget' um das
  189.    Fenster zu schliessen.
  190.  
  191.    ASwarm ist jetzt gestartet.  Nach 60 Sekunden wird der Schirm
  192.    abgeschaltet, natürlich nur, wenn Sie bis dahin keine Eingabe auf der
  193.    Tastatur gemacht haben, oder die Maus bewegt haben.
  194.  
  195.    Sie können ASwarm auch vom CLI oder einer anderen Shell starten.
  196.    So z.B. können Sie ASwarm in "S:User-Startup" starten:
  197.      Run >NIL: <NIL: ASwarm CX_POPUP=NO
  198.  
  199.    Die Argumente für den CLI-Start sind identisch zu den Tool Types
  200.    des WB-Starts.
  201.  
  202.    ASwarm unterstützt ab sofort auch die  "dos.library/ReadArgs()"
  203.    Routinen für Parameterübergabe. Starten Sie hierzu ASwarm aus dem
  204.    CLI heraus mit der Option '?'.
  205.  
  206. ARGUMENTE
  207.    Wie jedes gute Commodity unterstützt auch ASwarm Tool Type Einträge.
  208.    Klicken Sie dazu auf das ASwarm.info und drücken dann die
  209.    "Rechte-Amiga-Taste i", um einen Eintrag zu ändern oder einen neuen zu
  210.    definieren.
  211.  
  212.    Tatsächlich ist dies nicht mehr notwendig, da wir nun die Konfiguration
  213.    abspeichern können. Die Tool Types werden alle in das Icon von ASwarm
  214.    eingetragen.
  215.  
  216.    In den Tool Type Einträgen sind (per default) eingetragen:
  217.  
  218.     DONOTWAIT                 # Die WB soll nicht auf uns warten
  219.     CX_PRIORITY=0             # Priorität in der "commodities.library" Schlange
  220.     CX_POPUP=YES              # Konfigurations-Fenster beim Start öffnen.
  221.     CX_POPKEY=ctrl alt s      # Konfigurations-Fenster Tastenbefehl
  222.     BLANKKEY=ctrl alt b       # Sofort Schutz Tastenbefehl
  223.     TIMEOUT=60                # Zeit nach der ASwarm schonen soll
  224.     CLIENTTIMEOUT=5           # Zeit nach der der Client abgeschaltet wird
  225.     DISPLAY=PAL:Hires         # Beschreibung der Auflösung
  226.     CYCLE=YES                 # Farben-Cyclus einschalten
  227.     AIM=NO                    # Such Modus abgeschaltet
  228.     WASP=2                    # Anzahl Wespen
  229.     BEES=25                   # Anzahl Bienen
  230.     SPEED=4                   # Geschwindigkeit
  231.     TIGHTNESS=5               # Die Nähe der Bienen an Wespen
  232.     MOUSEBLANKMETHOD=Hardware # Wie die Maus geblankt werden soll
  233.  
  234.    Diese Tool-Type-Einträge sind der normale Weg für Commodities und reine
  235.    Workbenchprogramme, um Parameter zu übergeben.
  236.    Lesen Sie dazu bitte auch in Ihrem AmigaDOS Handbuch (Kapitel "Workbench
  237.    Programme", insbesondere das Kapitel "Der WBStartup Ordner") um eine
  238.    bessere Idee der Tool-Type-Einträge zu erhalten.
  239.  
  240. TOOL TYPE EINTRÄGE:
  241.     DONOTWAIT
  242.          Wenn von WBStartup gestartet, lass WB wissen, das es nicht
  243.          auf ASwarm warten soll.
  244.  
  245.     CX_PRIORITY=<-128 - 128>
  246.          Priorität in der "commodities.library" Schlange
  247.  
  248.     CX_POPUP=<YES | NO>
  249.          Das Konfigurations-Fenster soll beim Start erscheinen wenn auf
  250.          "YES" gesetzt.
  251.  
  252.     CX_POPKEY=<Tastenbefehl>
  253.          Bitte lesen Sie weiter unten mehr über die Tastenbefehle.
  254.          Damit wird das Konfigurationsfenster geöffnet.
  255.  
  256.     BLANKKEY=<Tastenbefehl>
  257.          Bitte lesen Sie weiter unten mehr über die Tastenbefehle.
  258.          Hiermit wird der Schoner sofort eingeschaltet.
  259.  
  260.     TIMEOUT=<1 - 3600>
  261.          Das ist der Auszeit-zähler in Sekunden. Innerhalb dieser Zeit darf
  262.          keine Eingabe erfolgt sein, um den Schoner zu starten.
  263.          Normal ist eine Zeit um 60 Sekunden.
  264.  
  265.     CLEINTTIMEOUT=<1 - 60>
  266.          Nach dieser Zeit schaltet der Server den Schirm ab, wenn er bemerkt,
  267.          das der Client nicht fähig war, etwas zu malen.
  268.          Normal ist eine Zeit um 5 Sekunden.
  269.  
  270.     DISPLAY=<Auflösungsbeschreibung>
  271.          Bitte sehen Sie weiter unten für die Auflösungen.
  272.          Hier können Sie die Größe ihres Screen einstellen, auf dem ASwarm
  273.          malt.
  274.  
  275.     WASPS=<1 - 10>
  276.          Anzahl der Wespen.
  277.  
  278.     BEES=<1 - 500>
  279.          Anzahl der Bienen.
  280.  
  281.     AIM=<YES | NO>
  282.          Wespen-Such-Modus ein oder ausschalten. (Default ist NO)
  283.  
  284.     CYLCE=<YES | NO>
  285.         Colorcycling ausschalten (Default ist YES).
  286.  
  287.     SPEED=<1 - 4>
  288.         Geschwindigkeit einstellen. 4 ist maximale Geschwindigkeit.
  289.  
  290.     TIGHTNESS=<1 - 10>
  291.         Stellt die Entfernung ein, die die Bienen minimal zur Wespe
  292.         haben dürfen. Je größer der Wert, umso näher.
  293.  
  294.     MOUSEBLANKMETHOD=<Hardware | FreeSprite>
  295.         Ab Version 1.3 von ASwarm II, wird der Mauszeiger immer mit Sprite
  296.         DMA abgeschaltet. Dies geht auf einigen VGA Grafikkarten nicht.
  297.         Die Option 'FreeSprite' benutzt eine Software Methode, um den
  298.         Mauszeiger abzuschalten, welche auch mit diesen Karten laufen
  299.         sollte. Achtung: FreeSprite verstümmelt auf AGA-Rechner den
  300.         Mauszeiger, benutzen sie also besser "Hardware".
  301.  
  302.    BEMERKEN SIE:
  303.     Die Tool-Type-Einträge sollten alle GROSS geschrieben werden.
  304.  
  305.    BEMERKEN SIE:
  306.     Aus Kompatibilitätsgründen unterstützen wir auch den Tool Type
  307.     "SECONDS", der identisch zu "TIMEOUT" ist.
  308.  
  309. TASTENBEFEHLE:
  310.    Bitte lesen Sie dazu bitte auch in Ihrem AmigaDOS Handbuch (Kapitel Die
  311.    Extras Programme, Der Commodities Ordner) um eine gültige Liste aller
  312.    erhältlichen Tastenbefehle zu erhalten, die folgende Übersicht mag mit einer
  313.    neueren Commodities.library obsolet sein.
  314.  
  315.    Die Tastenbefehle können in den String-Gadgets im Konfigurations-Fenster
  316.    eingegeben werden. Die Syntax und Korrektheit wird überprüft.
  317.  
  318.  
  319.    GEBRAUCH: [<Steuertaste> [<Steuertaste>...]] <Taste>
  320.  
  321.     Steuertasten Schlüsselwörter:
  322.     (Drücken und halten einer oder mehrerer Steuertasten)
  323.  
  324.       alt          Eine der ALT Tasten
  325.       ralt         Rechte ALT Taste
  326.       lalt         Linke Alt Taste
  327.       shift        Eine der Shift Tasten
  328.       lshift       Linke Shift Taste
  329.       rshift       Rechte Shift Taste
  330.       capslock     Caps Lock Taste
  331.       lcommand     Linke Amiga Taste
  332.       rcommand     Rechte Amiga Taste
  333.       control      Control Taste (CTRL)
  334.       numericpad   Schalter um den Nummernblock zu nutzen
  335.       rbutton      Rechte Maustaste drücken und halten
  336.       midbutton    Mittlere Maustaste drücken und halten
  337.                    (natürlich nur bei Mäusen mit einer solchen Taste)
  338.       lbutton      Linke Maustaste drückem und halten
  339.       newprefs     Preferences Änderung
  340.       diskremoved  Diskette entfernt
  341.       diskinserted Diskette eingeschoben
  342.  
  343.  
  344.       Tasten (drücken und loslassen, nur EINE Taste kann gewählt werden)
  345.  
  346.       a .. z, 0 .. 9, etc.    Normale Tasten
  347.       f1 .. f10               Funktionstasten
  348.       hoch, runter, links, rechts    Cursor Tasten
  349.       help                    Help Taste
  350.       del                     Delete Taste
  351.       return                  Return Taste
  352.       enter                   Enter Taste (Nur in Verbindung mit
  353.                               'numericpad' !)
  354.       backspace               Löschtaste
  355.       esc                     Escape Taste
  356.       space                   Leertaste
  357.       comma                   Komma Taste
  358.       upstroke                Hochkomma Taste
  359.  
  360.       Beispiele:
  361.  
  362.       lalt ralt return
  363.       rcommand f10
  364.       alt x
  365.       lalt numericpad enter
  366.  
  367.    BEMERKEN SIE:
  368.       Suchen Sie sich ihren Tastenbefehl VORSICHTIG aus, da Commodities eine
  369.       hohe Priorität in Eingabe-Auftritten haben (z.B. können Sie existierende
  370.       Definitionen überschreiben). Auch können Tastenbefehle keinen Sinn machen,
  371.       oder aber mit anderen Tools oder Funktionen der WB kollidieren.
  372.  
  373.    BEMERKEN SIE:
  374.       Der Workbench-Screen (bzw. der Default-PubScreen, wenn dieser den
  375.       Shanghai-Modus aktiviert hat) wird nach vorne geholt, wird das
  376.       ASwarm-Konfigurationsfenster mittles Tastenbefehl aufgerufen.
  377.  
  378.    BEMERKEN SIE:
  379.       Wenn eine Kombiantation einer Steuertaste und einer Taste illegal
  380.       ist, wird ASwarm gestartet aber der Tastenbefehl funktioniert nicht.
  381.       Beispiele für illegale Kombinationen:
  382.        lalt a b                     # Zwei Tasten gewählt
  383.        control rcommand lcommand    # Trivial :-)
  384.        lbutton                      # Keine Taste festgelegt
  385.  
  386.       Werden die Tastenbefehle mittels des Konfigurations-Fenster
  387.       eingegeben, so wird die Korrektheit überprüft. Wenn illegal, wird der
  388.       alte Tastenbefehl angezeigt.
  389.  
  390.    BEMERKEN SIE:
  391.       Wegen eines Fehlers in der Commodities Library ist es unmöglich,
  392.       einen Mausknopf ohne Steuertaste oder Taste zu benutzen.
  393.       (ParseIX() setzt die ix_QualMask nicht richtig)
  394.  
  395.  
  396. KONFIGURATIONSFENSTER
  397.    Wenn CX_POPUP auf 'YES' gesetzt wurde, und ASwarm gestartet wurde, oder
  398.    aber der Tastenbefehl gedrückt wurde, dann öffnet sich ein Fenster auf der
  399.    Workbench. Normalerweise wird die Workbench dazu nach vorne geholt.
  400.  
  401.    Wir haben das Konfigurationsfenster unter Berücksichtigung vieler möglicher
  402.    Umstände getestet. Teilen Sie uns bitte mit, wenn Sie ein Problem damit
  403.    haben.
  404.  
  405.    Sie sehen nun ein paar Gadgets und eine Scroll-Liste.
  406.  
  407.    Die Werte innerhalb der Text-Gadgets sind defaultmäßig auf die übergebenen
  408.    Werte der Tool Types oder CLI-Parameter gesetzt. Wird ein falscher Wert
  409.    eingegeben, wird der zuletzt benutzte Wert eingesetzt.
  410.  
  411.    Sie werden bemerken, das einige Gadgets einen Namen haben, in dem ein
  412.    Zeichen unterstrichen ist. Das sind Tastenbefehle, um die Gadgets
  413.    schnell zu erreichen und zu ändern ohne die Maus zu bewegen.
  414.  
  415.    In Slider- und Cycle-Gadgets kann mit dem Tastenbefehl der Slider nach
  416.    rechts, mit Shift und Tastenbefehl nach links bewegt werden.
  417.  
  418.    Die Zeichen in "[]" sind die Tastenbefehle.
  419.  
  420.    [T]imeout:
  421.     Der vorgegebene Wert für die Auszeit des Schoners. Nach dieser Zeit
  422.     (in Sekunden) wird der Schoner eingeschaltet. Werte zwischen 1 und 3600.
  423.  
  424.    C[l]ient timeout:
  425.     Die Zeit, die der Server dem Client gibt, nicht fähig zu sein, etwas zu tun.
  426.     Danach wird der Schirm echt abgeschaltet.
  427.  
  428.    [S]peed:
  429.     Cycle-Gadget, welches vom benutzten Prozessor abhängt (68000 bis 68040).
  430.     Geht von 'Slow Motion' bis 'Incredible'.
  431.  
  432.    [W]asps:
  433.     Anzahl der Wespen. Werte von 1 bis 10.
  434.  
  435.    B[E]es:
  436.     Anzahl der Bienen. Werte von 1 bis 500.
  437.  
  438.    T[i]ghtness:
  439.     Die relative Nähe der Bienen zur Wespe. Werte von 1 bis 10, hängt auch
  440.     ab von der Geschwindigkeit.
  441.  
  442.    [C]olor Cycling:
  443.     Ein- oder Abschalten des Farb-Zyklus.
  444.  
  445.    [A]im Mode:
  446.     Ein- oder Abschalten des Such-Modus. Die Bienen suchen dann die nächste
  447.     Wespe.
  448.  
  449.    [H]ide:
  450.     Schliest das Fenster. Alle bisdahin neu eingegebenen Werte werden
  451.     gemerkt und bei der nächsten Schonphase benutzt.
  452.  
  453.    [B]lank:
  454.     Sofort Schonphase einschalten. Alle bis dahin neu eingegebenen Werte werden
  455.     gemerkt und benutzt.
  456.  
  457.    [Q]uit:
  458.     ASwarm beenden. Ebenfalls möglich mit senden eines CTRL-C.
  459.  
  460.    DISPLAY MODE:
  461.     (Bitte sehen Sie dazu auch unten) Suchen Sie sich hier
  462.     Ihren Modus für den Schirm aus, der während der Schonphase verwendet werden
  463.     soll. Benutzen Sie den Schiebe-Balken um eventuell andere vorhandene Modi
  464.     anzuzeigen, dies hängt vom verwendetem System ab.
  465.     Sollten sie hier nur den System Default Modus sehen, so ist Ihr System
  466.     falsch installiert. Bitte lesen Sie auch in Ihrem AmigaDOS Handbuch unter
  467.     'Monitors' nach.
  468.  
  469.    [M]ouse Blank:
  470.     Schaltet die Methode des Mausblanks um.
  471.  
  472.  
  473.    Menü Einträge:
  474.  
  475.     Die Menus können auch per Tastatur ereicht werden, benutzen Sie die
  476.     angezeigten Tastenbefehle.
  477.  
  478.    Project-Menu:
  479.  
  480.     Load-Config:
  481.      Nur erhältlich, wenn ASwarm von der Workbench gestartet wurde.
  482.      Lädt die Konfiguration aus dem Icon.
  483.  
  484.     Save-Config:
  485.      Nur erhältlich, wenn ASwarm von der Workbench gestartet wurde.
  486.      Speichert die aktuelle Konfiguration in das Icon. Überschreibt dabei
  487.      alle vorhandenen Tool Type Einträge. Somit ist es nicht mehr notwendig,
  488.      die Tool Type Einträge zu edieren.
  489.  
  490.     About:
  491.      Zeigt Version und Copyright.
  492.  
  493.     Hide:
  494.      Schliesst das Konfigurations-Fenster.
  495.  
  496.     Quit:
  497.      Verläßt ASwarm.
  498.  
  499.    Edit-Menu:
  500.  
  501.     Reset To Defaults:
  502.      Setzt alle Parameter auf die eingebauten Werte zurück.
  503.  
  504.  
  505. COMMODITIES EXCHANGE
  506.    Mit dem Commodities Exchange Tool können Sie temporär ASwarm anhalten
  507.    mit DISABLE, erneut starten mit ENABLE, abbrechen mit KILL (so wie es QUIT
  508.    im Konfigurationsfenster tun würde), das Konfigurationsfenster anzeigen mit
  509.    SHOW und dieses mit HIDE wieder schliessen.
  510.  
  511.    Das Exchange Tool ist ein bequemer Weg, um ASwarm abzubrechen, es
  512.    anzuhalten oder erneut zu starten.
  513.  
  514.    Bitte lesen Sie dazu auch in Ihrem AmigaDOS Handbuch (Kapitel AmigaDOS
  515.    Reference und Workbench Programme) um mehr über das Exchange Tool zu
  516.    erfahren.
  517.  
  518. DISPLAY MODI:
  519.  
  520.                                Achtung !
  521.  
  522.    Bitte, bitte, bitte passen Sie hier auf!!! Wir sind NICHT verantwortlich
  523.    für IRGENDEINEN Benutzerfehler ihrerseits.
  524.    Die angezeigte Liste hängt von Ihrem System ab. Alle neueren Amigas, wie
  525.    etwa der A500+, A600, A2000C und A3000 haben alle die ECS-Denise für die
  526.    erweiterten Bildschirmmodi. Aber nicht alle Amiga mit einem 2.0 Kickstart
  527.    auf ROM haben auch eine ECS Denise... Natürlich können Sie alle gewünschten
  528.    Modi einschalten, aber nicht alle Modi sind auch auf jedem MONITOR
  529.    erhältlich. Bitte sehen Sie dazu auch in Ihrem AmigaDOS Handbuch
  530.    (Kapitel Workbench Programme, AddMonitor) für mehr Information.
  531.  
  532.    Die neuen Amiga 1200 und 4000 haben unter WB 3.0 und mit ihren AGA
  533.    Chips, nochmal ein komplett andere Liste.
  534.  
  535.    Warum ?  Ganz einfach. Sie könnten Ihren Monitor ZERSTÖREN.
  536.  
  537.    Hier ist eine Liste der (normal gegebenen) ECS Display Modi:
  538.    (Diese Liste ist nur für die Workbench V37.175 korrekt, neuere Versionen
  539.    der Workbench werden neue, andere Modi besitzen, diese Liste ist nur ein
  540.    Beispiel)
  541.  
  542.       NTSC:Lores
  543.       NTSC:Hires
  544.       NTSC:SuperHires
  545.       NTSC:Lores-Interlaced
  546.       NTSC:Hires-Interlaced
  547.       NTSC:SuperHires-Interlaced
  548.       PAL:Lores
  549.       PAL:Hires
  550.       PAL:SuperHires
  551.       PAL:Lores-Interlaced
  552.       PAL:Hires-Interlaced
  553.       PAL:SuperHires-Interlaced
  554.       VGA-ExtraLores                  # -
  555.       VGA-ExtraLores-Interlaced       #
  556.       VGA-Lores                       #
  557.       VGA-Lores-Interlaced            #   Multiscan Monitor wird benötigt
  558.       Productivity                    #
  559.       Productivity-Interlaced         # -
  560.       A2024_10Hz                      #
  561.       A2024_15Hz                      #   A2024 benötigt
  562.  
  563.    Andere Modi werden von Fremdherstellern unterstüzt.
  564.  
  565.    Overscan wird bei allen Modi benutzt, stellen Sie Ihre Overscan-Größe
  566.    bitte mit dem ScreenMode Preference Tool ein.
  567.  
  568.    Diese Liste ist nur dann erhältlich, wenn das Icon 'Mode_Names' im
  569.    WBStartup-Ordner vorhanden ist. Dies mag mit einer neuen Version der
  570.    Workbench überflüßig sein.
  571.  
  572.    BEACHTEN SIE:
  573.     Nutzen Sie NIE die VGA-Modi auf einem NON-VGA- oder NON-Multisync
  574.     Monitor.
  575.     Versuchen Sie noch NICHT einmal die Modi zu TESTEN, wenn Sie
  576.     nicht sicher sind über ihre Monitor-Fähigkeiten.
  577.  
  578.    Da das Original xswarm auf X11-Workstationen arbeitet, und diese normal
  579.    ein höheres der Grafikauflösung des Amigas haben, ziehe ich SuperHires vor,
  580.    da dieser Modus dem Original nahe kommt. ASwarm II benutzt 4 Farben.
  581.  
  582.    BEMERKEN SIE:
  583.     Seien sie gewarnt.
  584.  
  585.    ACHTUNG:
  586.     Die oben angegebene Liste wird unter Garantie KOMPLETT anders aussehen,
  587.     lassen sie ASwarm II auf einem A1200/A4000 mit den neuen AGA Modi der
  588.     Workbench 3.0 laufen.
  589.  
  590. BEKANNTE PROBLEME:
  591.    Wir wissen von einigen Problemen und rätselhaften Verhalten, einige von
  592.    Ihnen sind es nicht mehr, wenn Sie dies gelesen haben:
  593.  
  594.    - Nutzen Sie ARQ 1.66 oder kleiner ? (Ersatz der System Requester)
  595.      Dann sollten Sie dies ausprobieren:
  596.  
  597.      Ändern Sie das Timeout auf einen kleinen Wert, z.B. 5 Sekunden, dann
  598.      tippen Sie folgendes im CLI:
  599.          wait 10 <RETURN>  (nicht auf das Prompt warten)
  600.          dir blafasel: <Return> (Das Gerät blafasel: sollte nicht existieren)
  601.  
  602.      ASwarm schaltet den Schonschirm ein, wie gewöhnlich, aber dann öffnet
  603.      ARQ einen Requester AUF dem ASwarm-Schirm !! Sie können den Schirm nicht
  604.      eher schliessen, als bis Sie auf 'ABORT' geklickt haben. Und ASwarm kann
  605.      den Schirm auch nicht mehr schonen (Es wartet ja immer noch vergeblich
  606.      auf die erfolgreiche Rückkehr des ScreenClose() )
  607.  
  608.      Das ist ein BUG in ARQ ! Er mag in einigen Fällen gefährlich sein, er
  609.      könnte den Requester auf den Schirm brennen.
  610.      Bitte installieren sie die neueste Version von ARQ (V1.78), und das
  611.      Problem sollte behoben sein.
  612.  
  613.    - Sie haben einen C-Compiler am laufen, oder einen Raytracer. ASwarm
  614.      schaltet den Schonschirm ein, aber nicht eine Biene ist zu sehen, und nur
  615.      während Diskettenzugriff kommen mal ein paar Bienen.
  616.  
  617.      Das ist KEIN Bug, das ist DAS Feature von ASwarm !! Das ist der Weg
  618.      auf dem ASwarm den Schirm schont, wenn bereits viel CPU-Zeit von anderen
  619.      Prozessen benutzt wird. Während einen Diskettenzugriff ist dann die
  620.      CPU-Zeit für Aswarm wieder da, und findet ein wenig Zeit etwas zu malen.
  621.  
  622.    - Wenn bei eingeschaltetem Schonschirm eine Diskette eingelegt wird,
  623.      wird der Schirm abgeschaltet. Dies ist normal, da Diskettenbewegung als
  624.      Eingabe erkannt wird, genau wie alle anderen Eingaben den Schirm auch
  625.      abschalten sollen.
  626.  
  627.    - ASwarm startet nicht, obwohl es im WBStartup-Ordner steht.
  628.      Naja, das passiert wenn eine falsche Kombination von Tastenbefehl benutzt
  629.      wurde. Versuchen Sie bitte eine andere Kombination einzugeben. Testen Sie
  630.      ihren Tastenbefehl !
  631.  
  632.    - ASwarm zeigt sein Konfigurationsfenster obwohl der Tool Type CX_POPUP
  633.      auf 'NO' gesetzt wurde. Das passiert, wenn ASwarm zweimal gestartet wird.
  634.      (Doppelklick (oder Aufruf vom CLI) = Start, erneuter Doppelklick (oder
  635.      Aufruf vom CLI) öffnet das Fenster)
  636.  
  637.    - ASwarm ist verdammt langsam. Huh.. 'tschuldigung :-) Die Autoren haben
  638.      eine schnelle Machine. Versuchen Sie die Anzahl der Wespen oder Bienen
  639.      herabzusetzten. Oder nutzen Sie einen weniger großen Schirm.
  640.  
  641.    - ASwarm macht Lärm wenn es den Schonschirm einschaltet. Das passiert
  642.      wenn ein Display Modus gewählt wurde, der unterschiedlich zum
  643.      aktuellen schirm ist. Und es passiert bei alten Monitoren mit
  644.      Lautsprecher. Ungefährlich.
  645.  
  646.    - ASwarm verursacht Flicker auf dem Monitor, wenn es den Schonschirm
  647.      einschaltet. Das passiert, wenn Aswarm auf einem PAL-Schirm schonen soll,
  648.      aber der bisdahin aktive Schirm NTSC war (oder umgekehrt). Der Monitor
  649.      braucht nur Zeit, sich neu zu synchronisieren. Ungefährlich.
  650.  
  651.    - Kollisionen mit anderen Blankern. Tja, Sie können soviele Blanker
  652.      laufen lassen, wie Sie wollen. Etwa DMouse, Spliner, Fracblanc.
  653.      ASwarm versucht immer seinen Screen nach vorne zu holen, wenn es merkt
  654.      das der eigene hinten ansteht.
  655.  
  656.    - Das Konfigurationsfenster öffnet sich nicht, wenn der Tastenbefehl gedrückt
  657.      wurde. Vielleicht haben Sie einen falschen Tastenbefehl benutzt. Benutzen
  658.      Sie das Exchange Tool um das Fenster zu öffnen. Im Gadget 'Pop Key' steht
  659.      der aktuelle Tastenbefehl. Er kann hier geäandert werden, und auch getestet
  660.      werden. Wird ein falscher Tastenbefehl übergeben, wird der alte Tastenbefehl
  661.      wieder erscheinen.
  662.  
  663.    - Es gibt einen 70Hz Hack für Multisync Monitore und einer
  664.      Productivity Umgebung (WB). Dieser kann bei ASwarm fehllaufen. Kein Bug von
  665.      ASwarm, andere Programme laufen ebensowenig.
  666.      Unter der WB 3.0 und WB 2.1 gibt es den Screenmodus "Euro 72", der Ihnen
  667.      auch für ASwarm den 70Hz Modus zur Verfügung stellt.
  668.  
  669.  
  670.    - Es gibt tatsächlich Leute, die keine Workbench gestartet haben, die
  671.      werden dann leider nie mehr als einen HiRes-Screen einschalten dürfen.
  672.      Warum ? Die Mode_Names-Liste wird von der Workbench gestartet. Und
  673.      das Screenmode Preferences benutzt wohl hard-codierte Screen-Auflösungen.
  674.      Wir wollten aber nur die Modi unterstützen, die auch die Workbench
  675.      unterstützt. Ohne WB nix los (die schlappen 30 k..).
  676.  
  677.      Unter WB 3.0 und WB 2.1 ist allerdings auch dieses Problem behoben.
  678.      Einfach den Monitor Typ im System anhängen.
  679.  
  680.    - Die Bienen formieren sich nicht zu einem schönen Scharm. Das ist kein
  681.      Bug, sondern das ist versehentlich einer Rationalisierung zum Opfer
  682.      gefallen. Ist verändert worden.
  683.  
  684. GRÜßE UND BLUMEN:
  685.  
  686.    Jeff Butterworth für sein xswarm unter für X11, erhältlich als
  687.    xlock-Modus und als Stand-alone Programm. Wir haben seine Routinen
  688.    allerdings so stark verändert, das wir nur sagen können, das es nur
  689.    'locker' auf xswarm gebaut ist.
  690.  
  691.    Matt Dillon für seinen DICE. So konnten wir es schaffen, ASwarm mit
  692.    einem der meist verwendesten Low-Cost C-Compiler zu entwickeln. (Nur die
  693.    registrierte Version)
  694.  
  695.    Stefan Becker, Deutscher Distributor von Dice, der immer nocht überredet
  696.    werden konnte, ASwarm II zu benutzen .. :-)
  697.  
  698.    SAS/C Gruppe für Ihre hervorragende Arbeit. Die SAS-Version ist bislang
  699.    schneller und kürzer.
  700.  
  701.    Roger 'Budda' Westlund, für den Bugreport vom 70Hz Hack.
  702.  
  703.    Willi 'Amico' Räckers, für sein ewiges Nörgeln :-)
  704.  
  705.    Jörg 'Skull' Bublath, für seine Idee mit dem AIM-Modus.
  706.  
  707.    Markus 'Corwin' Stipp, der uns mit dem DICE half, und uns auf das Problem
  708.    mit den interleaved Bitmaps von 3.0 aufmerksam machte.
  709.  
  710.    Fred Fish, Mr. Public Domain, hoffe du magst das hier um es in einer
  711.    deiner nächsten 'Fishe' zu publizieren. Erlaubnis hiermit gegeben.
  712.    (Grmbl, wir haben FF770, und ich habe immer noch keinen Streamer :^)
  713.  
  714.    Andrew 'Guardian' Denton, der uns sagte, das Jay Miner unseren Blanker
  715.    mag, und der einige neue Ideen einbrachte.
  716.  
  717.    Dr. P. Kittel, der uns auf der CeBIT '92 erlaubte, ASwarm II unter der
  718.    Workbench 2.1 zu testen. Es funktioniert immer noch korrekt, auch mit
  719.    den vielen neuen Features. Peter, 'dein' Amiga-Ball-Blanker ist fast
  720.    fertig :-)
  721.  
  722.    Jake Rose, der ein paar neue Features in ASwarm III einbrachte, die wir
  723.    z.T. in ASwarm II 1.3 nachmachten (nicht eine Zeile seines Codes wurde
  724.    benutzt). Wenn er uns doch bloss nur einfach seine Ideen vorgeschlagen
  725.    hätte anstatt einen Clone zu fabrizieren...
  726.  
  727.    Rickard 'Richie' Olsson, der uns erzählte, das seine Katze 'Pixel'
  728.    ASwarm mag, und das ASwarm ihn überredete einen Bildschirmschoner
  729.    einzusetzen.
  730.  
  731.    Roger 'Budda' Westerlund, der uns vom 70Hz Hack erzählte.
  732.  
  733.    Roland Bless für die Beseitigung einiger Bugs im CLI Parameter Kram.
  734.  
  735.    Michael Janich für die Entdeckung eines fiesen Bugs in der blankkey
  736.    routine.
  737.  
  738.    Holger 'Hal' Lubitz für den sehr guten Artikel über ASwarm II im
  739.    Amiga Plus Magazin 11/92
  740.  
  741.    Dank auch an diverse Netz-Teilnehmer für ihre (eigenartigen)
  742.    Bug-reports.
  743.  
  744.         Markus Illenseer
  745.         Matthias Scheler
  746.          Dezember 1992
  747.